
<!DOCTYPE html>

<html lang="en">
  <head>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />

    <title>First steps as a user &#8212; LAVA 2024.05 documentation</title>
    <link rel="stylesheet" type="text/css" href="_static/pygments.css" />
    <link rel="stylesheet" type="text/css" href="_static/bootstrap-sphinx.css" />
    <script data-url_root="./" id="documentation_options" src="_static/documentation_options.js"></script>
    <script src="_static/jquery.js"></script>
    <script src="_static/underscore.js"></script>
    <script src="_static/_sphinx_javascript_frameworks_compat.js"></script>
    <script src="_static/doctools.js"></script>
    <script src="_static/sphinx_highlight.js"></script>
    <link rel="shortcut icon" href="_static/favicon.ico"/>
    <link rel="index" title="Index" href="genindex.html" />
    <link rel="search" title="Search" href="search.html" />
    <link rel="next" title="Submitting your first job" href="first-job.html" />
    <link rel="prev" title="Getting support" href="support.html" />
    <link rel="canonical" href="https://docs.lavasoftware.org/lava/first_steps.html" />
  
<meta charset='utf-8'>
<meta http-equiv='X-UA-Compatible' content='IE=edge,chrome=1'>
<meta name='viewport' content='width=device-width, initial-scale=1.0, maximum-scale=1'>
<meta name="apple-mobile-web-app-capable" content="yes">
<script type="text/javascript" src="_static/js/jquery-1.12.4.min.js"></script>
<script type="text/javascript" src="_static/js/jquery-fix.js"></script>
<script type="text/javascript" src="_static/bootstrap-3.4.1/js/bootstrap.min.js"></script>
<script type="text/javascript" src="_static/bootstrap-sphinx.js"></script>


  </head><body>

  <div id="navbar" class="navbar navbar-default navbar-fixed-top">
    <div class="container">
      <div class="navbar-header">
        <!-- .btn-navbar is used as the toggle for collapsed navbar content -->
        <button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".nav-collapse">
          <span class="icon-bar"></span>
          <span class="icon-bar"></span>
          <span class="icon-bar"></span>
        </button>
        <a class="navbar-brand" href="index.html"><span><img src="_static/lava.png"></span>
          LAVA</a>
        <span class="navbar-text navbar-version pull-left"><b>2024.05</b></span>
      </div>

        <div class="collapse navbar-collapse nav-collapse">
          <ul class="nav navbar-nav">
            
                <li><a href="genindex.html">Index</a></li>
                <li><a href="contents.html">Contents</a></li>
            
            
              <li class="dropdown globaltoc-container">
  <a role="button"
     id="dLabelGlobalToc"
     data-toggle="dropdown"
     data-target="#"
     href="index.html">Site <b class="caret"></b></a>
  <ul class="dropdown-menu globaltoc"
      role="menu"
      aria-labelledby="dLabelGlobalToc"><ul class="current">
<li class="toctree-l1"><a class="reference internal" href="index.html">Introduction to LAVA</a></li>
<li class="toctree-l1 current"><a class="reference internal" href="contents.html">Contents</a></li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="glossary.html">Glossary of terms</a></li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="support.html">Getting support</a></li>
</ul>
</ul>
</li>
              
                <li class="dropdown">
  <a role="button"
     id="dLabelLocalToc"
     data-toggle="dropdown"
     data-target="#"
     href="#">Page <b class="caret"></b></a>
  <ul class="dropdown-menu localtoc"
      role="menu"
      aria-labelledby="dLabelLocalToc"><ul>
<li><a class="reference internal" href="#">First steps as a user</a><ul>
<li><a class="reference internal" href="#logging-in">Logging In</a><ul>
<li><a class="reference internal" href="#local-user-account">Local User Account</a></li>
<li><a class="reference internal" href="#linaro-lab-users">Linaro lab users</a></li>
</ul>
</li>
<li><a class="reference internal" href="#authentication-tokens">Authentication Tokens</a></li>
</ul>
</li>
</ul>
</ul>
</li>
              
            
            
              
                
  <li>
    <a href="support.html" title="Previous Chapter: Getting support"><span class="glyphicon glyphicon-chevron-left visible-sm"></span><span class="hidden-sm hidden-tablet">&laquo; Getting support</span>
    </a>
  </li>
  <li>
    <a href="first-job.html" title="Next Chapter: Submitting your first job"><span class="glyphicon glyphicon-chevron-right visible-sm"></span><span class="hidden-sm hidden-tablet">Submitting yo... &raquo;</span>
    </a>
  </li>
              
            
            
            
            
              <li class="hidden-sm"></li>
            
          </ul>

          
            
<form class="navbar-form navbar-right" action="search.html" method="get">
 <div class="form-group">
  <input type="text" name="q" class="form-control" placeholder="Search" />
 </div>
  <input type="hidden" name="check_keywords" value="yes" />
  <input type="hidden" name="area" value="default" />
</form>
          
        </div>
    </div>
  </div>

<div class="container">
  <div class="row">
    <div class="body col-md-12 content" role="main">
      
  <section id="first-steps-as-a-user">
<span id="first-steps-using-lava"></span><h1>First steps as a user<a class="headerlink" href="#first-steps-as-a-user" title="Permalink to this heading">¶</a></h1>
<section id="logging-in">
<span id="index-0"></span><span id="id1"></span><h2>Logging In<a class="headerlink" href="#logging-in" title="Permalink to this heading">¶</a></h2>
<p>Each LAVA instance offers a <a class="reference internal" href="#local-user"><span class="std std-ref">Local User Account</span></a> and may also be configured to an
alternative authentication method:</p>
<ul class="simple">
<li><p><a class="reference internal" href="authentication.html#ldap-authentication"><span class="std std-ref">Using Lightweight Directory Access Protocol (LDAP)</span></a></p></li>
</ul>
<div class="admonition seealso">
<p class="admonition-title">See also</p>
<p><a class="reference internal" href="authentication.html#user-authentication"><span class="std std-ref">Configuring user authentication</span></a> for more information.</p>
</div>
<p>LDAP authentication relies on local configuration and may involve obtaining a
privileged access token from the LDAP administrators.</p>
<p>Local accounts remain available for all instances.</p>
<p>Whichever authentication method is used, there is no difference in how users
interact with LAVA once logged in.</p>
<section id="local-user-account">
<span id="local-user"></span><h3>Local User Account<a class="headerlink" href="#local-user-account" title="Permalink to this heading">¶</a></h3>
<p>A local user account may be created by an administrator within LAVA. The
administrator may grant different permissions to the user to perform various
operations within LAVA. A typical login screen will look something like the
following.</p>
<img alt="_images/local-user-login.png" src="_images/local-user-login.png" />
<p>To log in with a username and password, enter your credentials in the provided
text boxes and click “Login” button.</p>
<p>Local user accounts can be particularly useful for automated users like build
systems or continuous integration scripts using the XML-RPC API. In this case, a local
admin can create the user with a secure password, log in as that user to create
an authentication token and then supply the token to the scripts.</p>
</section>
<section id="linaro-lab-users">
<h3>Linaro lab users<a class="headerlink" href="#linaro-lab-users" title="Permalink to this heading">¶</a></h3>
<p>Linaro’s central validation lab in Cambridge is accessible via
<a class="reference external" href="https://validation.linaro.org/">https://validation.linaro.org/</a> . It is Linaro’s core production instance of
LAVA.</p>
<p>This lab is configured to use Linaro LDAP. To log in, enter your details in the
LDAP login fields.</p>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>If your Linaro email is <code class="docutils literal notranslate"><span class="pre">first.second&#64;linaro.org</span></code> then use
<code class="docutils literal notranslate"><span class="pre">first.second</span></code> as your username.</p>
</div>
<img alt="_images/ldap-user-login.png" src="_images/ldap-user-login.png" />
<p>A successful authentication will redirect you to <a class="reference external" href="https://validation.linaro.org/">https://validation.linaro.org/</a></p>
<p>If you do not have a Linaro LDAP account, you can register at
<a class="reference external" href="https://register.linaro.org/">https://register.linaro.org/</a>.</p>
<p>After logging in, the LAVA scheduler page will look something like the
following:</p>
<img alt="_images/lava-scheduler-page.png" src="_images/lava-scheduler-page.png" />
</section>
</section>
<section id="authentication-tokens">
<span id="index-1"></span><span id="id2"></span><h2>Authentication Tokens<a class="headerlink" href="#authentication-tokens" title="Permalink to this heading">¶</a></h2>
<p>In order to securely access LAVA resources via XML-RPC APIs using lavacli or
XML-RPC clients, users first need to create an authentication token.</p>
<p>Once logged in to a LAVA instance (e.g. <a class="reference external" href="https://validation.linaro.org/">https://validation.linaro.org/</a>), click
on the “API” link then on the “Authentication Tokens” link from the drop down
menu. The following page will appear</p>
<img alt="_images/authentication-tokens-page.png" src="_images/authentication-tokens-page.png" />
<p>Click on the “New” button on the above page which raises a dialog box asking
for a description of the token to help you identify and delete tokens - if
required at a later stage.</p>
<img alt="_images/create-new-authentication-token.png" src="_images/create-new-authentication-token.png" />
<p>Click on the “Create” button to generate the token. The token will be assigned
a token number (which is autogenerated by LAVA).</p>
<img alt="_images/sample-token-page.png" src="_images/sample-token-page.png" />
<p>To display the token that was generated above click on the green “Display this
token” button in the Actions column on the above page.</p>
<img alt="_images/token-display-page.png" src="_images/token-display-page.png" />
<p>If a token is compromised, it can be removed by clicking on the red “delete
this token” button in the Actions column. Anyone using that token will then no
longer be able to authenticate as you in the system.</p>
</section>
</section>


    </div>
      
  </div>
</div>
<footer class="footer">
  <div class="container">
    <p class="pull-right">
      <a href="#">Back to top</a>
      
    </p>
    <p>
        &copy; Copyright 2010-2019, Linaro Limited.<br/>
      Created using <a href="http://sphinx-doc.org/">Sphinx</a> 5.3.0.<br/>
    </p>
  </div>
</footer>
  </body>
</html>